home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1996 May
/
EnigmA AMIGA RUN 07 (1996)(G.R. Edizioni)(IT)[!][issue 1996-05][EARSAN CD VI].iso
/
rubriche
/
host-cont
/
mwm101.lha
/
MWM
/
Docs
/
MWM_eng.DOC
next >
Wrap
Text File
|
1996-04-04
|
24KB
|
686 lines
Version 1.01
+--- - - - - ---+--- - - - - ---+
| ! Welcome to the first very easy-to-use HTML file generator ! |
+--- - - - - ---+--- - - - - ---+
__ __ __ __ __ __
/ \_/ \ \ \ / / / \_/ \
/ /\ /\ \ \ \ _ / / / /\ /\ \
/ / \_/ \ \ \ \ / \ / / / / \_/ \ \
/ / \ \ \ \/ _ \/ / / / \ \
/_/ \_\ \__/ \__/ /_/ \_\
-->* Magic WWW (World-Wide Web) files Maker *<--
_______________________________________
|
|
\|/
X
___________________________________
| |
| from an idea of Maurizio Fabiani |
| developed by Massimo Baglione |
|___________________________________|
0> FIRST
Please, excuse my painful english! (;-))
1> INTRODUCTION
One day my friend Maurizio ask to me: "Hey Max, do you think that can be possible
to write a program to create files in HTML format just loading a simple ASCII text
and handle it with the mouse to define the final HTML file ?"
I said: "Oh my God! Miracles are not my speciality!"... but he won!
Well, the final result is near.
MWM, infact, allows you to load a normal text file and by the mouse is possible to attach
images, texts, lists and many other HTML object to the selected lines and/or words.
The GUI is essentially composed by:
- Main window, that will show the normal loaded text file.
If a part of text is defined by an action, then it will be highlighted with a different
color from the rest of the text.
Like some word processors, this window contains a lot of small graphic gadgets linked
to different actions.
- Single Line window:
- Labels window, that will show all labels included in a file HTML to be linked.
(see later).
- Help window (or Log window).
- "What is ?" window.
2> MAIN WINDOW
Once loaded a simple text file, you can see it into the Main Window.
With the left mouse button you can select a part of the text and with one of the
instruments gadgets can be possible to attach an action to it like lists, texts,
images, hyperlinks and many other stuffs permitted by the HTML 3.0 specs.
If you need to attach an action to a single word into a line, it's sufficient a
double-click on this line.
The Single Line window will appear with your desired line.
Any action will create an object that will be showed on the Main Window with different
colors.
Any created object will be numbered in order of creation and by selecting it it's
possible to check the essential data into the Log Window.
If text is greater the the window, you can scroll it by pressing arrows keys or using
the scroll gadgets.
Starting from the first gadget on the left, we have:
- First gadget (TEXT)
This action will define for selected lines a particular type of text.
If you are working on the Single Line window, MWM will show the following choices:
- It's a link to an already defined label into the current document.
- It's a link to an other document.
In this case a program like Mosaic will highlight this part of text
and, if the user click on this object, than a new text defined by this
action will called.
After choosing the file to be linked, MWM will ask you if you need to
refer to a label into the linked text.
If yes, a listview will show a complete list of its labels.
Just do a doubble-click to make the choice.
- It's a link to a site.
MWM will show a requester to know where it can go to read the site name.
You can choose from:
- Selected line.
The site name is the current selected text.
In this case MWM will reduce to one all selected lines.
- Keyboard.
The site name will be defined manually by the keyboard.
- PATH:file.
The site name is specified into the previously defined file name
defining the configuration.
MWM will give you the following list:
file://localhost/
http://
ftp://
mailto:
news:
gopher:
telnet:
Onse choosed, you must add the complete name of the site.
If not previously defined, MWM will find the sites list
into the file:
"PROGDIR:MWM.sites".
The list MUST look like that:
maui@mbox.vol.it
mwm@the.best.world
you@example.any.ok
...
It's possible to define a different location for that file
using the "Preferences" menu function.
- It's a simple text.
Otherwise, if you are working on the Main Window with one or more selected lines,
MWM will expand the previous choices with the following:
- It's a preformatted text.
- It's a paragraph.
Selected lines will be incleded between <P> and </P>.
MWM will ask you an allineament: DEFAULT, LEFT, RIGHT, JUSTIFY.
- It's an information about you.
Selected lines will be incleded between <ADDRESS> and </ADDRESS>.
- Second gadget (IMAGE)
This action will _REPLACE_ selected text with an image.
A file requester will be opened to you to select the image file.
After this, MWM will ask you what type of image you desire:
- It's a link to an already defined label into the current document.
- It's a link to an other document.
In this case a program like Mosaic will highlight this part of text
and, if the user click on this object, than a new text defined by this
action will called.
After choosing the file to be linked and the alignement type for this image,
MWM will ask you if you need to refer to a label into the linked text.
If yes, a listview will show a complete list of its labels.
Just do a doubble-click to make the choice.
- It's a link to a site. (See above on the TEXT part)
- It's a MAP image.
- It's a simple image.
The following are a list of possible alignement for an image:
- BOTTOM
- MIDDLE
- TOP
- Third gadget (LIST)
This action will define selected lines as a list.
There are three types of lists:
- Unnumbered, for example:
* it's cold
* it's warm
* it's rain
- Numbered, for example:
1- Don't drink if you must drive
2- Don't drive if you have drunk
3- Cappuccino is more greedy than beer
4- Milk is finish, give my a beer!
- Definition, for example:
Colors
Red
Green
Blue
Planetarium
Mercury
Mars
Jupiter
Earth
...
After choosing the right type, MWM will ask you if you want to add more infos
to every element of the list.
If not, the list will become a simple list of words.
If yes, MWM will show you line by line the selected text asking you what
you want to define:
- It's a link to an already defined label into the current document.
- It's a link to an other document. (See TEXT and IMAGE)
- It's a link to a site. (See above on the TEXT part)
- It's a simple text.
- Fourth gadget (FORM)
This action is composed by two steps:
The first step:
where you define the part of the text that will become the FORM.
MWM will ask you the type: the possible responses are GET, POST and Cancel.
After this, MWM needs to know the Action (like URL).
This is an example of Action: "http://x/y/sample".
Now you can see that the color of selected text is changed.
How you can see, only in FORM object is possible to select one or more
lines into.
The second step:
only now it's possible to define all other stuffs of the FORM.
You have the following possibilities:
- It's a simple text
Useful to describe some other more important objects.
- It's an INPUT
This choice will open a requester with the following type of input:
1> Text 7> file
2> Password 8> Hidden
3> Checkbox 9> Submit
4> Radio 10> Image
5> Range 11> Reset
6> Scribble
If you choose the number 4 (RADIO), MWM will check if selected lines
are more than one.
In that case, MWM will ask you if you want to include these into the
same RADIO group.
If yes, the RADIO group will have the same field name.
In this way, a program like Mosaic can be sure that one and only one of
it can be selected by the user.
- It's a list of INPUTs
Don't work if you are working on the single line window.
Any single INPUTs to define will be included in a list.
Every element of the FORM (except that inserted in a list) will be saved into
the final HTML file prefixed by the <P> string just to separate
one line from another one.
If you needs to insert two or more element of the FORM into the same line, it's
possible to do a double-click on it using the Single Line window.
- Fifth gadget (MORE)
This action changes if you are working on the Main Window or on the Single Line
window.
In the first case:
if selected text are uninitialized (in other words without objects),
MWM will reduce to one all selected lines asking you what you want to do with
this line.
These are the possibilities:
- Insert label here (<ID>) for hyperlinks;
- Insert comment here (<!-- -->);
- Define title for current document (<TITLE>).
- Define the background image (<BODY BACKGROUND>).
- Insert empty line. (<P>)
- Insert horizontal graphic line (<HR>).
Otherwise, if selected text are initialized, MWM will expand the previous
questions with the following:
- Citation (Typically in italic). (CITE)
- Emphasis (EM)
- Strong emphasis (STRONG)
- Code (CODE)
Look like preformatted text, for example: 1 + 1 = 2.
- Author (AU)
For an author of a book etc...
- Person (PERSON)
For a generic person name.
- Sequence of chars. (SAMP)
- Keyboarded text. (KBD)
- Variable name. (VAR)
- Definition. (DFN)
- Short quote. (Q)
- Acronyms. (ACRONYM)
- Abbreviations. (ABBREV)
- Inserted text. (INS)
- Deleted text. (DEL)
- Bold text. (B)
- Italic text. (I)
- Typewriter text. (TT)
- Underscored text. (U)
- "Lined" text. (S)
- Big text. (BIG)
- Small text. (SMALL)
- To understand (;-)). (SUB)
- To anderstand (;-)) (SUP)
If selected lines are part of the HEAD, than a different requester will be
showed to you with:
- Attach a BANNER
With this action you can choose an HTML file to be a fixed banner.
ex: <LINK REL=Banner HREF=mypath:mybanner.HTML>
In the second case:
this action will work if into the Single Line window there is a created
and selected object.
If selected object is a text, MWM will show you these choices:
- Citation (Typically in italic). (CITE)
- Emphasis (EM)
- Strong emphasis (STRONG)
- Code (CODE)
Look like preformatted text, for example: 1 + 1 = 2.
- Author (AU)
For an author of a book etc...
- Person (PERSON)
For a generic person name.
- Sequence of chars. (SAMP)
- Keyboarded text. (KBD)
- Variable name. (VAR)
- Definition. (DFN)
- Short quote. (Q)
- Acronyms. (ACRONYM)
- Abbreviations. (ABBREV)
- Inserted text. (INS)
- Deleted text. (DEL)
- Bold text. (B)
- Italic text. (I)
- Typewriter text. (TT)
- Underscored text. (U)
- "Lined" text. (S)
- Big text. (BIG)
- Small text. (SMALL)
- To understand (;-)). (SUB)
- To anderstand (;-)) (SUP)
- Sixth gadget (HEAD)
This action will define selected lines as HEAD.
Into the HEAD are essentially defined the TITLE of the document, some others
informations and the selected text.
By using MORE action you can insert a banner.
- Seventh gadget (SIZE)
With this action you can modify the font size of the selected lines.
The following are the possible choices:
- <H1> Very large font, bold.
- <H2> Large font, bold.
- <H3> Large font, italic..
- <H4> Normal font, bold.
- <H5> Normal font, italic.
- <H6> Small font.
Note that these values are just an indication.
When loading a simple text, MWM set this value to <H5> to every lines.
Use the "HTML defaults" into the "Preferences" menu to change this default.
Onse choosed, you can select an alignement:
- LEFT (default)
- CENTER
- LEFT
- JUSTIFY
- Eighth gadget (VIEW)
This action allows you to call a program like Mosaic to see at any time
the final work.
3> "What is ?" WINDOW
You can see this window on the left of the Main Window.
Example:
*-----------**----------------------------------*
| What is ? || MWM Edit Window |
------------- -----------------------------------
| ........ || Uninitialized text |
| Text Hn X || Initialized Text |
| Head || Text of the <HEAD> block |
| Form ABC_1|| Text of the <FORM> block |
| Preformat || Preformatted text <PRE> |
| Address || Text of the <ADDRESS> block |
| Paragraph || Paragraph text <P> |
| List XL || Text of the <LIST> block |
| Image || Text that will be an image |
| To site || Hyperlink to a site |
| Multi obj || Text including more objects |
| Label || There are a label <ID> |
| Comment || There are a comment <!-- ... -->|
| Lab & Com || There are both label and comment |
|___________||__________________________________|
Description:
Hn = Heading <H1> to <H6>, <HD> for default value.
X = Allignement: L = LEFT C = CENTER R = RIGHT J = JUSTIFY
XL = List type: UL = Unnumbered OL = Numbered DL = Definition
ABC_1 = Form method: Get or Post.
4> THE MENU
Into the main window you can use a menu with the following items:
* Project
- Load text
Allows to load a normal ASCII text file.
If a text was already loaded, MWM will ask if you want to delete it
or to attach the new to the old.
In the first case, MWM will ask the insertion type:
- To the beginning;
- To the end;
- From the first selected line.
- Save html
Allows you to save the work creating the desired HTML file.
MWM needs to know if you want to save also all uninitialized text or not.
If not, than only created objects, labels and comments will be included
into the HTML file.
Else, if yes, all uninitialized text will be saved as simple text and
the string <BR> will be added to the end of each line of it.
After this MWM will check for title and, if not exists, a requester will
help you.
- Load saved work
Load a previously saved work.
- Save work
Save the entire work in a file to be recalled at any time to continue
the development of it.
- About.
The MWM's brain and arm! (;-))
- Quit
End of work.
* Edit
- Cut
This action kill completely all selected lines or only the created infos
- Search new
Search a new string.
- Search again.
Search the same string.
- Edit selected lines
This action allows you to modify the selected text.
The previously created objects will NOT touched.
* Action
- Text \
- Image \
- List \
- Form \___\ Same functions of the gadgets into the main window.
- More / /
- Head /
- Size /
- Viev /
* Preferences
- Texts path
To define a common path for all texts.
- Images path
To define a common path for all images.
- Work dir
To define your favourite working directory (ex: RAM:t).
- Browser
To choose the preview program, for example AMosaic or IBrowse.
- Sites list
To choose the file containing the list of sites.
- Screen prefs
To change the graphic mode for MWM screen.
I like CUSTOM mode.
- Select new font
Change the current font in main window.
- Edit log window
Allows you to personalize the Log Window.
- HTML defaults
To personalize some defaults on the final HTML file.
In this version, this action will open the following requester:
- Heading size;
The MWM's default for headings is H5 and all uninitialized
text will be saved as H5.
If you want a different heading size, just select one of
H1 H2 H3 H4 H5 H6
into the listview.
- All
To define all the previous at the same time.
When done, MWM will ask you if you want to save the preferences file
"MWM.prefs" into ENV: and ENVARC:.
- GENERAL INFORMATIONS
MWM needs OS 3.0 or greater.
This program was constructed following the HTML specs included into the archive
HTML30GU.LHA findable in any BBS and in aminet.
This version is absolutely Copyright!
If you like this program and you need all disabled function, you can send me
25 US dollars to the following address:
Massimo Baglione
Via Acqua Fredda (Marrone int. 9)
67040 Rocca S. Stefano
Tornimparte L' AQUILA (Italy)
specifying where I can send the KEY disk.
For any suggestion, idea or mail bombs, please contact more fast as possible:
Massimo Baglione Maurizio Fabiani
(MAUI for Amiga BBS)
39:102/1.5 AmigaNet 39:102/1
39:102/2.5 39:102/2
2:335/602.5 FidoNet 2:335/602
2:335/607.5 2:335/607
InterNet
(Maurizio Fabiani) maui@mbox.vol.it
- GREATINGS
I must thanks all my betatesters for their good bug report about MWM.
In particular, I want to quote (in alphabetical order):
Troy Bouchar (Snowy Hill)
Mel Greer
for their incredible minds!
Ross Delaforce
for his FTP support
More, a big kiss (!) is flying to my Boss (Maurizio Fabiani) for its
neverending patience!
The last greating is reserved to Amiga: (all together) ...THANKS AMIGA!!!
-----+-----
-=> * \X/ Amiga! \X/ MAUI BBS! \X/ Love and Beer! * <=-
...enjoy this program!!!
